home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / netutils / lsp135.arj / LSP135.DSK / unc.dsk / READCID.001 < prev    next >
Text File  |  1993-12-15  |  48KB  |  1,562 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  READCID.001 FOR THE LOCAL AREA NETWORK SUPPORT PROGRAM, VERSION 1.35
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  (C) Copyright IBM Corp. 1993                                                1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  CONTENTS
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  READCID.001 FOR THE LOCAL AREA NETWORK SUPPORT PROGRAM, VERSION 1.35   . .  1
  79.  Target Audience  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  80.  Related Document   . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  81.  Setting Up for CID Installations   . . . . . . . . . . . . . . . . . . . .  3
  82.  Loading LSP on the Code Server   . . . . . . . . . . . . . . . . . . . . .  3
  83.  Installation of LSP on a Boot Diskette for Pristine Installations  . . . .  3
  84.  
  85.  RESPONSE FILE PROCESSING   . . . . . . . . . . . . . . . . . . . . . . . .  4
  86.  CID Environment Variable   . . . . . . . . . . . . . . . . . . . . . . . .  4
  87.  DXMAID Command Line Parameters   . . . . . . . . . . . . . . . . . . . . .  4
  88.  Response File Format   . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  89.  INST_SECTION parameters  . . . . . . . . . . . . . . . . . . . . . . . . .  6
  90.  PROT_SECTION parameters  . . . . . . . . . . . . . . . . . . . . . . . . .  8
  91.  Other Response File Parameters   . . . . . . . . . . . . . . . . . . . .   10
  92.  Driver Diskettes (Option Diskettes)  . . . . . . . . . . . . . . . . . .   11
  93.  NDIS Protocol Drivers (DXME0MOD.SYS and DXMJ0MOD.SYS)  . . . . . . . . .   11
  94.  Non-NDIS LSP Drivers   . . . . . . . . . . . . . . . . . . . . . . . . .   12
  95.  Installed LAN Adapters   . . . . . . . . . . . . . . . . . . . . . . . .   12
  96.  LSP Module Driver Names  . . . . . . . . . . . . . . . . . . . . . . . .   13
  97.  Removing LSP from the Configuration  . . . . . . . . . . . . . . . . . .   13
  98.  Processing Additional PROTOCOL.INI Files   . . . . . . . . . . . . . . .   14
  99.  CID Return Codes   . . . . . . . . . . . . . . . . . . . . . . . . . . .   14
  100.  Log Files  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  101.  Unsupported Function in Response File  . . . . . . . . . . . . . . . . .   15
  102.  
  103.  APPENDIX A.  EXAMPLE RESPONSE FILES  . . . . . . . . . . . . . . . . . .  A-1
  104.  DXMC0MOD.SYS and DXMT0MOD.SYS, One Adapter   . . . . . . . . . . . . . .  A-1
  105.  DXMC0MOD.SYS and DXMT0MOD.SYS, Two Adapters  . . . . . . . . . . . . . .  A-2
  106.  DXMJ0MOD.SYS and IBMTOK.DOS, One Adapter   . . . . . . . . . . . . . . .  A-4
  107.  DXME0MOD.SYS, DXMT0MOD.SYS and IBMTOK.DOS, One Adapter   . . . . . . . .  A-5
  108.  Migration to DXMJ0MOD.SYS and IBMTOK.DOS   . . . . . . . . . . . . . . .  A-7
  109.  DXMJ0MOD.SYS and IBMTOK.DOS, Two Adapters  . . . . . . . . . . . . . . .  A-7
  110.  
  111.  
  112.  TARGET AUDIENCE
  113.  
  114.  This document is intended for the Configuration Installation Distribution
  115.  (CID) administrator, who should be familiar with NetView(*) DM/2 (NV DM/2) or
  116.  an equivalent CID software distribution agent.
  117.  
  118.  
  119.  RELATED DOCUMENT
  120.  
  121.  If you are using NV DM/2, we recommend that you read Automated Installation
  122.  of CID-Enabled DOS 6, LAN Support Program 1.35, and NetView DM/2 2.0,
  123.  SC31-6833-00 before reading this file.
  124.  
  125.  
  126.  
  127.  
  128.  (C) Copyright IBM Corp. 1993                                                2
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  SETTING UP FOR CID INSTALLATIONS
  138.  
  139.  This section describes loading the LAN Support Program (LSP) on the code
  140.  server and installing LSP on a boot diskette for pristine installations.
  141.  
  142.  
  143.  LOADING LSP ON THE CODE SERVER
  144.  
  145.  Use the DOS XCOPY command with the /S parameter to load LSP onto the code
  146.  server.  The following example assumes that the LSP source diskette is in the
  147.  A drive and that the current drive is the code server drive:
  148.  
  149.     md lspsrc
  150.     xcopy a: lspsrc /s
  151.  
  152.  The directory structure on the code server and the name of the directory
  153.  where the LSP source is copied is the administrator's decision.
  154.  
  155.  NOTE:  The /S parameter on the XCOPY command is necessary, since the LSP
  156.  source diskette contains subdirectories.
  157.  
  158.  
  159.  INSTALLATION OF LSP ON A BOOT DISKETTE FOR PRISTINE INSTALLATIONS
  160.  
  161.  The diskette is assumed to be at the code server machine (preparation
  162.  workstation).  The code server should already have the LSP, DOS, and NV DM/2
  163.  source images installed.  The DOS kernel and other required DOS files should
  164.  be installed on the diskette before you install LSP.
  165.  
  166.  Make the subdirectory containing the LSP files the current directory and
  167.  perform a normal attended installation.  Make sure to answer the following
  168.  questions as indicated below.
  169.  
  170.  On the Setup screen you need to provide the following information.
  171.  
  172.       Are you updating an existing configuration?    NO
  173.       Do you have driver diskettes?                  YES  (if using NDIS)
  174.       Target for LSP:                  A:\  (or appropriate drive and path)
  175.       CONFIG.SYS to update:            A:\  (or same drive as above)
  176.       AUTOEXEC.BAT to update:          A:\  (or same drive as above)
  177.  
  178.  On the Process Driver Diskette screen (if using NDIS) you need to provide the
  179.  drive and path where the NDIS MAC driver files are located for the adapter
  180.  this boot diskette is intended to support.
  181.  
  182.  NOTE:  A boot diskette can support only one adapter interface driver.
  183.  
  184.  After the LSP installation is finished, invoke the NV DM/2 install program to
  185.  finish building the boot diskette.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                                                    Contents  3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  RESPONSE FILE PROCESSING
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  The response file is an ASCII file that is used by the installation program
  209.  to replace the interactive user input.  The DXMAID /R:  parameter identifies
  210.  a response file
  211.  
  212.  
  213.  CID ENVIRONMENT VARIABLE
  214.  
  215.  If the REMOTE_INSTALL_STATE environment variable is not null, then LSP
  216.  installation assumes that the CID software distribution agent (for example,
  217.  NV DM/2) is present.  In this case, the LSP installation program presents no
  218.  panels when it runs; this is unattended mode.  The CID completion status (see
  219.  "CID Return Codes" on page 14) is returned to the software distribution
  220.  agent.  The REMOTE_INSTALL_STATE environment variable is set by the CID
  221.  software distribution agent.
  222.  
  223.  
  224.  DXMAID COMMAND LINE PARAMETERS
  225.  
  226.  /R:       The argument to this parameter is the file name of the LSP response
  227.            file.  This argument must either be fully qualified or present in
  228.            the current directory.  There is no default for this parameter; if
  229.            it is not specified, no response file processing is done.
  230.  
  231.  /S:       The argument to this parameter is the source drive and path where
  232.            the LSP installation files are to be found.  It overrides the
  233.            SourcePath parameter of the response file.  The default is the path
  234.            where DXMAID.EXE is located.
  235.  
  236.  /T:       The argument to this parameter is the target drive and path where
  237.            the LSP configuration (other than updated CONFIG.SYS and
  238.            AUTOEXEC.BAT) are to be copied.  It overrides the response file
  239.            TargetPath parameter.  The default is d:\LSP, where the letter d
  240.            represents the lowest (alphabetically) hard drive designator or
  241.            drive A (if no hard drive is available).
  242.  
  243.            NOTE:  For attended install, the maximum length of the argument to
  244.            this parameter is 20 characters.
  245.  
  246.  /TU:      The argument to this parameter is the path where the source/target
  247.            CONFIG.SYS and AUTOEXEC.BAT are located.  This parameter overrides
  248.            the response file ControlFilePath parameter.  The default for this
  249.            parameter is the root directory of the drive where LSP is being
  250.            installed.
  251.  
  252.            NOTE:  For attended install, the maximum length of the argument to
  253.            this parameter is 6 characters.
  254.  
  255.  
  256.  
  257.  
  258.  (C) Copyright IBM Corp. 1993                                                4
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  /G:       The argument to this parameter is the drive/path to search for
  268.            included response files.  See "Other Response File Parameters" on
  269.            page 10 for details about how this parameter is used.
  270.  
  271.  /L1:      The argument to this parameter is the file name of the LSP log
  272.            file.  It must either be fully qualified or present in the current
  273.            directory.  There is no default for this parameter; if it is not
  274.            specified, no logging is performed.
  275.  
  276.  /X        This parameter causes DXMAID.EXE to be invoked in unattended mode.
  277.            The default is to invoke in attended mode.
  278.  
  279.            NOTE:  This parameter does not cause installation return codes to
  280.            be communicated to the software distribution agent.  See "CID
  281.            Environment Variable" on page 4 and "CID Return Codes" on page 14
  282.            for more information.
  283.  
  284.  NOTE:  The hyphen (-) can be used interchangeably with the slash (/) to
  285.  designate the DXMAID command line parameters.  These parameters are not case
  286.  sensitive.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                                                    Response File Processing  5
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  RESPONSE FILE FORMAT
  333.  
  334.     ; comments begin with ';' or '*'
  335.     INST_SECTION = (
  336.        AdapterCheck = <0 or 1>
  337.        DriverDiskPath = <file path to MAC driver driver disk image>
  338.        MigrateControlFiles = <0 or 1>
  339.        TargetPath =     <path for LSP files>
  340.        SourcePath =     <location for LSP source files (including NIFs)>
  341.        ControlFilePath =<path for CONFIG.SYS and AUTOEXEC.BAT>
  342.      )
  343.  
  344.     PINIFILE = <PROTOCOL.INI file path and name>
  345.     INCLUDE  = <include response file path and name>
  346.  
  347.     PROT_SECTION = (
  348.       drivername    =  <drivername for section>
  349.       ; bindings only required (and allowed) for protocol drivers
  350.       bindings      =  <section_name(s) for MAC drivers to bind>
  351.       section_name  =  <bracketed module name of relevant section>
  352.       driverfile    =  < file name of driver to load in CONFIG.SYS>
  353.       copyfile      =  < name of file(s) to copy to target>
  354.       nif           =  < NIF for the section.  Required for SMC>
  355.       lsp_primary   =  <0 or 1>
  356.       lsp_alternate =  <0 or 1>
  357.       ... keywords ...
  358.     )
  359.  
  360.  Response file contents are not case sensitive.
  361.  
  362.  All items are processed as they are encountered in the response file.  The
  363.  last value seen for a keyword is the effective value for the keyword.
  364.  
  365.  
  366.  INST_SECTION PARAMETERS
  367.  
  368.  ADAPTERCHECK             This is a boolean parameter.  If it is set to a
  369.                           nonzero number, the installed adapters are checked
  370.                           (see "Installed LAN Adapters" on page 12).  If this
  371.                           parameter is set to 0, the installed adapters are
  372.                           not checked.  The default is to check the installed
  373.                           adapters.
  374.  
  375.                           NOTE:  This parameter should be set to 0 when making
  376.                           a bootable diskette.
  377.  
  378.  CONTROLFILEPATH          Path where source and target CONFIG.SYS and
  379.                           AUTOEXEC.BAT are located.  The default is the root
  380.                           directory of the drive containing the target path.
  381.  
  382.                           NOTE:  For attended install, the maximum length of
  383.                           the argument to this parameter is 6 characters.
  384.  
  385.  
  386.  
  387.  
  388.                                                    Response File Processing  6
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  DRIVERDISKPATH           Path to driver disk files for the MAC driver; the
  398.                           path to your MAC driver and NIF files.  The last
  399.                           DriverDiskPath specified is the one in effect.  If
  400.                           this path is specified, it is used also as the
  401.                           source location of all files specified by
  402.                           PROT_SECTION keywords.
  403.  
  404.                              DriverDiskPath = <file specification>
  405.  
  406.                           The search hierarchy for the DriverDiskPath is:
  407.  
  408.                           1.  If possible, the file specification is used as
  409.                               is.
  410.  
  411.                           2.  The current directory is searched for the file
  412.                               specification.
  413.  
  414.                           3.  The source path for LSP code is searched for the
  415.                               file specification.
  416.  
  417.                               NOTE:  The source path for LSP code can be
  418.                               designated with the /S:  DXMAID command line
  419.                               parameter.  See "DXMAID Command Line Parameters"
  420.                               on page 4.
  421.  
  422.                           There is no default for this parameter; if it is not
  423.                           present, then driver diskette processing is not done
  424.                           and the SourcePath is used as the source location of
  425.                           all files specified by PROT_SECTION keywords.  See
  426.                           "Driver Diskettes (Option Diskettes)" on page 11 for
  427.                           more information.
  428.  
  429.                           NOTE:  This parameter is unrelated to the
  430.                           attended-mode driver diskette processing.
  431.  
  432.  MIGRATECONTROLFILES      This is a boolean parameter.  If it is set to a
  433.                           nonzero number, the current control files are used
  434.                           in computing the new configuration.  If this
  435.                           parameter is set to 0, the current control files are
  436.                           ignored when computing the new configuration.  The
  437.                           default is to use the current control files in
  438.                           computing the new configuration.
  439.  
  440.  REMOVE
  441.  
  442.                           NOTE:  Do not use this parameter in the NV DM/2
  443.                           environment.
  444.  
  445.                           If the final value encountered for this boolean
  446.                           parameter is a nonzero number, the CONFIG.SYS and
  447.                           AUTOEXEC.BAT commands that cause LSP to be loaded in
  448.                           memory will be removed from the output CONFIG.SYS
  449.                           and AUTOEXEC.BAT files.  If the final value
  450.                           encountered for this parameter is 0, the parameter
  451.  
  452.  
  453.                                                    Response File Processing  7
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.                           has no effect.  Additional response file parameters
  463.                           may be necessary if the configuration to be removed
  464.                           contains an NDIS MAC driver for which there is no
  465.                           NIF.  See "Removing LSP from the Configuration" on
  466.                           page 13 for more information.
  467.  
  468.  SOURCEPATH               Path to LSP source files, other than DXMAID.EXE and
  469.                           DXMAID.ccc.  The default is the path where
  470.                           DXMAID.EXE is located.  If DriverDiskPath is not
  471.                           specified, then this path is also used as the source
  472.                           path of all files specified by PROT_SECTION
  473.                           keywords.
  474.  
  475.  TARGETPATH               Path where LSP files (other than CONFIG.SYS and
  476.                           AUTOEXEC.BAT) should be written.  The default path
  477.                           is normally C:\LSP or A:\LSP, depending on whether
  478.                           the system has a hard drive.
  479.  
  480.                           NOTE:  For attended install, the maximum length of
  481.                           the argument to this parameter is 20 characters.
  482.  
  483.  
  484.  PROT_SECTION PARAMETERS
  485.  
  486.  PROT_SECTIONs may be used for NDIS MAC drivers and for the LSP drivers listed
  487.  under "LSP Module Driver Names" on page 13.
  488.  
  489.  DRIVERNAME This is the driver name described in the NDIS spec.  It is also
  490.            used for non-NDIS LSP drivers.  See the examples in Appendix A,
  491.            "Example Response Files" on page A-1 to see how it is used to
  492.            identify various LSP drivers.  This parameter is usually
  493.            required.(1)  See "LSP Module Driver Names" on page 13 for driver
  494.            names with their associated LSP driver files.
  495.  
  496.  BINDINGS  This is the bindings statement described in the NDIS spec.  It is
  497.            allowed only for protocol drivers; for them, it is REQUIRED.  If no
  498.            drivers are bound, "bindings = " must be specified.
  499.  
  500.            NOTE:  The bindings statement MUST be specified for DXME0MOD.SYS
  501.            and for DXMJ0MOD.SYS.
  502.  
  503.  SECTION_NAME This parameter is useful when you have no NIF.  The value of
  504.            this parameter must match the bracketed module name for the
  505.            relevant PROTOCOL.INI section.
  506.  
  507.            The section_name parameter is used for two purposes:
  508.  
  509.  
  510.  
  511.  ---------------
  512.  
  513.  (1) It may be omitted for NDIS MAC drivers if the section_name parameter is
  514.      present and the value for the section_name matches with a section name in
  515.      the PROTOCOL.INI.
  516.  
  517.  
  518.                                                    Response File Processing  8
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.            o   It is used to match the appropriate section in PROTOCOL.INI
  528.                with the target of a bindings= statement.
  529.  
  530.            o   For NDIS_SNGL MAC drivers, it is also used to distinguish
  531.                between the first (primary) and second (alternate) sections for
  532.                that MAC driver.
  533.  
  534.                NOTE:  For other types of MAC driver, the driver name differs
  535.                between the two sections, so the driver name is used to
  536.                distinguish between the two sections.
  537.  
  538.                NOTE:  The default component type is NDIS_SNGL.
  539.  
  540.            Example4.RSP on page A-5. shows the use of this parameter.
  541.  
  542.  DRIVERFILE This is the name of the driver to load in CONFIG.SYS and to copy
  543.            to the target LSP path.  This parameter is needed only for NDIS MAC
  544.            drivers for which no IBM format NIF is available.  This parameter
  545.            is not supported for drivers with IBM format NIFs.  See
  546.            "Unsupported Function in Response File" on page 15 for the error
  547.            message that is generated when this parameter is specified for a
  548.            driver that has an IBM format NIF.  For LSP driver files with their
  549.            associated driver names, see "LSP Module Driver Names" on page 13.
  550.  
  551.  COPYFILE  This is the copyfile statement described in the IBM NIF
  552.            specification.
  553.  
  554.  NIF       This parameter specifies the NIF for the section.  It can be a
  555.            useful parameter for SMC adapters using SMCMAC.DOS, since three
  556.            different NIFs use the same driver name.
  557.  
  558.  LSP_PRIMARY This is a boolean parameter.  If it is set to a nonzero number in
  559.            a PROT_SECTION for a non-NDIS LSP driver, the driver is added to
  560.            the configuration for the primary (CCB 0) adapter.  If set to 0 in
  561.            a PROT_SECTION for a non-NDIS LSP driver, the driver is removed
  562.            from the configuration for the primary adapter.  If this parameter
  563.            is not present in the PROT_SECTION for a non-NDIS LSP driver, then
  564.            the PROT_SECTION causes driver parameters to be updated only.
  565.  
  566.            NOTE:  This parameter is acted upon as it is encountered; that is,
  567.            the configuration may be changed each time the parameter is
  568.            encountered.  The non-NDIS LSP drivers are: DXMCnMOD.SYS,
  569.            DXMT0MOD.SYS and DXMGnMOD.SYS, where the letter n represents a
  570.            number (0, 1, or 2) that identifies the particular driver.
  571.  
  572.  LSP_ALTERNATE This is a boolean parameter.  If it is set to a nonzero number,
  573.            in a PROT_SECTION for a non-NDIS LSP driver, the driver is added to
  574.            the configuration for the alternate (CCB 1) adapter.  If set to 0
  575.            in a PROT_SECTION for a non-NDIS LSP driver, the driver is removed
  576.            from the configuration for the alternate adapter.  If this
  577.            parameter is not present in the PROT_SECTION for a non-NDIS LSP
  578.            driver, then the PROT_SECTION causes driver parameters to be
  579.            updated only.
  580.  
  581.  
  582.  
  583.                                                    Response File Processing  9
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.            NOTE:  This parameter is acted upon as it is encountered; that is,
  593.            the configuration may be changed each time the parameter is
  594.            encountered.
  595.  
  596.            The lsp_primary and lsp_alternate parameters are used for the
  597.            non-NDIS LSP drivers only:  DXMCnMOD.SYS, DXMGnMOD.SYS, and
  598.            DXMT0MOD.SYS.  These parameters are needed for DXMCnMOD.SYS and
  599.            DXMGnMOD.SYS only if the desired configuration does not reflect the
  600.            installed LAN adapters, since the shared RAM token-ring network
  601.            adapters and the PC Network adapters are detected by LSP
  602.            installation.
  603.  
  604.  
  605.  OTHER PROT_SECTION PARAMETERS
  606.  
  607.  Any other PROT_SECTION parameters are treated as PROTOCOL.INI parameters or
  608.  CONFIG.SYS command line parameters for the driver.  Each of these parameters
  609.  is updated as it is encountered in the response file.
  610.  
  611.  PROT_SECTION driver parameters not present in the NIF will be used as is.
  612.  (This differs from PROTOCOL.INI processing, where driver parameters not
  613.  present in the NIF are ignored.)
  614.  
  615.  NOTE:  A response file should never contain a PROT_SECTION for DXMA0MOD.SYS,
  616.  NETBIND.COM, or PROTMAN.DOS.  These files are automatically added to the
  617.  configuration as needed.
  618.  
  619.  
  620.  OTHER RESPONSE FILE PARAMETERS
  621.  
  622.  PINIFILE  This parameter specifies an additional PROTOCOL.INI file.  This
  623.            PROTOCOL.INI will be used in addition to the normal installation
  624.            PROTOCOL.INI.  (The normal installation PROTOCOL.INI is either the
  625.            one in the current configuration or the one in the LSP source--
  626.            depending on whether there is a PROTOCOL.INI in the current
  627.            configuration and on whether the current configuration is being
  628.            used to compute the new configuration.)
  629.  
  630.               PINIFILE = <file specification>
  631.  
  632.            The search hierarchy for PINIFILE files is:
  633.  
  634.            1.  If possible, the file specification is used as is.
  635.  
  636.            2.  The current directory is searched for the file specification.
  637.  
  638.            3.  The source path for LSP code is searched for the file
  639.                specification.
  640.  
  641.                NOTE:  The source path for LSP code can be designated with the
  642.                /S:  DXMAID command line parameter.  See "DXMAID Command Line
  643.                Parameters" on page 4.
  644.  
  645.  
  646.  
  647.  
  648.                                                   Response File Processing  10
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.            If you process an additional PROTOCOL.INI, you are limited in the
  658.            naming of any sections (stanzas) in the new PROTOCOL.INI that
  659.            correspond with sections in the normal installation PROTOCOL.INI.
  660.            You must use the same section names (bracketed module names) for
  661.            corresponding sections in the two PROTOCOL.INIs.
  662.  
  663.            See "Processing Additional PROTOCOL.INI Files" on page 14 for more
  664.            information.
  665.  
  666.  INCLUDE   This parameter specifies additional response files.
  667.  
  668.               INCLUDE = <file specification>
  669.  
  670.            The search hierarchy for additional response files is:
  671.  
  672.            1.  If possible, the file specification is used as is.
  673.  
  674.            2.  The current directory is searched for the file specification.
  675.  
  676.            3.  The path (if any) designated in the /G: command line parameter
  677.                is searched for the file specification.
  678.  
  679.            There is a limit of six nested response files.  However, the sixth
  680.            response file cannot contain a PINIFILE.
  681.  
  682.            NOTE:  Installation fails with an error if an include file cannot
  683.            be found.
  684.  
  685.  
  686.  DRIVER DISKETTES (OPTION DISKETTES)
  687.  
  688.  One driver diskette path (for NDIS MAC drivers) can be processed in an
  689.  unattended CID install.  The path to the driver diskette files is specified
  690.  via the INST_SECTION DriverDiskPath parameter.
  691.  
  692.  Some MAC drivers do not have an IBM format NIF available.  CID installation
  693.  of these MAC drivers is handled through PROT_SECTION response file entries,
  694.  which contain copyfile= for each ancillary file (such as a message file) that
  695.  needs to be copied to the target and driverfile= for the driver that needs to
  696.  be loaded in CONFIG.SYS (and also copied to the target).
  697.  
  698.  NOTE:  In attended mode, this processing occurs immediately prior to
  699.  attended-mode driver diskette processing.  There is no connection between
  700.  this parameter and attended-mode driver diskette processing.
  701.  
  702.  
  703.  NDIS PROTOCOL DRIVERS (DXME0MOD.SYS AND DXMJ0MOD.SYS)
  704.  
  705.  NDIS protocol driver response file PROT_SECTIONs have coding rules similar to
  706.  PROTOCOL.INI sections.  The bindings= statement is required so that the
  707.  installation utility will recognize the section as a protocol driver section.
  708.  Also, keyword values for both adapters are coded on the same line:
  709.  
  710.      keyword = val1, val2
  711.  
  712.  
  713.                                                   Response File Processing  11
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  See the st parameter on page A-3 for an example of the format for entering
  723.  keyword values in PROT_SECTION.
  724.  
  725.  Global boolean parameters are permitted.  An example of a global boolean
  726.  parameter is the X parameter of DXME0MOD.SYS.  The format for a global
  727.  boolean parameter is shown in EXAMPLE4.RSP on page A-5.  NDIS Protocol
  728.  drivers do not support the lsp_primary and lsp_alternate keywords.
  729.  
  730.  See "DXME0MOD.SYS, DXMT0MOD.SYS and IBMTOK.DOS, One Adapter" on page A-5 for
  731.  DXME0MOD.SYS parameters.  See the LSP User's Guide for DXMJ0MOD.SYS
  732.  parameters and their format.
  733.  
  734.  
  735.  NON-NDIS LSP DRIVERS
  736.  
  737.  The non-NDIS LSP drivers are: DXMCnMOD.SYS, DXMT0MOD.SYS and DXMGnMOD.SYS.
  738.  
  739.  Non-NDIS LSP driver response file sections are similar to NDIS protocol
  740.  driver response file sections in the way keywords are handled.  Keywords are
  741.  coded as
  742.  
  743.      keyword = val1, val2
  744.  
  745.  Global boolean keywords are also allowed.  An example of a global boolean
  746.  parameter is the E (Enabled) parameter of DXMT0MOD.SYS.  Non-NDIS LSP drivers
  747.  support the lsp_primary and lsp_alternate keywords.
  748.  
  749.  Non-NDIS LSP drivers do not support the bindings= statement.
  750.  
  751.  See "DXMC0MOD.SYS and DXMT0MOD.SYS, One Adapter" on page A-1 for DXMC0MOD.SYS
  752.  parameters.  See the LSP User's Guide for DXMT0MOD.SYS parameters.  Only the
  753.  short form of the DXMT0MOD.SYS parameters shown in the LSP User's Guide is
  754.  supported.
  755.  
  756.  
  757.  INSTALLED LAN ADAPTERS
  758.  
  759.  Installed hardware is not checked if you set AdapterCheck to 0 in the
  760.  INST_SECTION of a response file.
  761.  
  762.  LSP installation checks only for Shared RAM token-ring adapters, PC Network
  763.  adapters, and a few Micro Channel adapters.  These Micro Channel adapters
  764.  are:
  765.  
  766.  o   IBM FDDI adapter
  767.  
  768.  o   IBM Ethernet adapter (based on the SMC Ethernet adapter)
  769.  
  770.  o   SMC Micro Channel Ethernet adapter listed in the LSP 1.33 User's Guide
  771.  
  772.  o   Ungermann-Bass Micro Channel Ethernet adapter listed in the LSP 1.33
  773.      User's Guide
  774.  
  775.  o   3COM Micro Channel Ethernet adapter listed in the LSP 1.33 User's Guide
  776.  
  777.  
  778.                                                   Response File Processing  12
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  If the user specifies that the current configuration be used, any NDIS MAC
  788.  drivers specified in bindings for LSP protocol drivers have precedence over
  789.  installed adapters.
  790.  
  791.  
  792.  LSP MODULE DRIVER NAMES
  793.  
  794.  The following are the LSP driver files with their associated driver names.
  795.  
  796.  +-------------------------------------+-------------------------------------+
  797.  | DRIVER FILE                         | DRIVER NAME                         |
  798.  +-------------------------------------+-------------------------------------+
  799.  | DXME0MOD.SYS                        | DXME0$                              |
  800.  +-------------------------------------+-------------------------------------+
  801.  | DXMJ0MOD.SYS                        | NETBEUI$                            |
  802.  +-------------------------------------+-------------------------------------+
  803.  | DXMC0MOD.SYS                        | DXMC0MOD$                           |
  804.  +-------------------------------------+-------------------------------------+
  805.  | DXMC1MOD.SYS                        | DXMC1MOD$                           |
  806.  +-------------------------------------+-------------------------------------+
  807.  | DXMT0MOD.SYS                        | DXMT0MOD$                           |
  808.  +-------------------------------------+-------------------------------------+
  809.  | DXMG0MOD.SYS                        | DXMG0MOD$                           |
  810.  +-------------------------------------+-------------------------------------+
  811.  | DXMG1MOD.SYS                        | DXMG1MOD$                           |
  812.  +-------------------------------------+-------------------------------------+
  813.  | DXMG2MOD.SYS                        | DXMG2MOD$                           |
  814.  +-------------------------------------+-------------------------------------+
  815.  
  816.  
  817.  REMOVING LSP FROM THE CONFIGURATION
  818.  
  819.  NOTE:  Do not remove LSP from the configuration in the NV DM/2 environment.
  820.  
  821.  To remove LSP from the workstation configuration via CID, set Remove to 1 in
  822.  the INST_SECTION of the response file.
  823.  
  824.  (This has the same effect as setting AdapterCheck to 0  and setting
  825.  MigrateControlFiles to 0 in the INST_SECTION of the response file.)
  826.  
  827.  If there are CONFIG.SYS statements for NDIS MAC drivers for which no NIFs are
  828.  available, it is necessary to add a PROT_SECTION with the appropriate
  829.  DriverFile = for each NDIS MAC driver in the old configuration for which no
  830.  NIF is available in the target directory.
  831.  
  832.  NOTE:  Be sure to specify the target directory correctly so that LSP
  833.  installation can locate NIFs for any NDIS MAC drivers in the configuration.
  834.  
  835.  NOTE:  If the response file also contains PROT_SECTIONs for an NDIS protocol
  836.  driver (DXME0MOD.SYS or DXMJ0MOD.SYS) and the last bindings= statement
  837.  encountered for this protocol driver specifies drivers to be bound, then LSP
  838.  will not be removed from the output configuration.
  839.  
  840.  
  841.  
  842.  
  843.                                                   Response File Processing  13
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.      INST_SECTION = (
  853.         Remove = 1
  854.      )
  855.      ; The following section would be needed if there were no IBM format
  856.      ; NIF for IBMTOK.DOS and that file was being loaded in CONFIG.SYS.
  857.      PROT_SECTION = (
  858.         DriverName = ibmtok$
  859.         driverfile = IBMTOK.DOS
  860.         )
  861.  
  862.  NOTE:  If the input configuration contains only non-NDIS LSP drivers (for
  863.  example, DXMC0MOD.SYS and DXMT0MOD.SYS), then only the Remove = 1 is needed
  864.  to remove LSP from the workstation configuration.
  865.  
  866.  
  867.  PROCESSING ADDITIONAL PROTOCOL.INI FILES
  868.  
  869.  Normally, LSP installation uses either the PROTOCOL.INI file in the existing
  870.  configuration (as specified in the CONFIG.SYS file PROTMAN.DOS load line) or
  871.  the sample one in the LSP code source image.
  872.  
  873.  One of the response file parameters is PINIFILE.  This parameter is used to
  874.  introduce a PROTOCOL.INI file other than the one in the existing
  875.  configuration or the one in the LSP code source image.
  876.  
  877.  A limitation of PROTOCOL.INI processing is that the bracketed module names
  878.  (as well as the driver names) for corresponding PROTOCOL.INI sections must
  879.  match.  For this reason, the user may need to specify that the existing
  880.  configuration not be used when an additional PROTOCOL.INI is used.
  881.  
  882.  See "DXMJ0MOD.SYS and IBMTOK.DOS, Two Adapters" on page A-7 for a
  883.  configuration that uses PINIFILE.
  884.  
  885.  
  886.  CID RETURN CODES
  887.  
  888.  If the REMOTE_INSTALL_STATE environment variable (see "CID Environment
  889.  Variable" on page 4) is set, LSP installation communicates install completion
  890.  status back to the software distribution agent as a 2-byte return code via
  891.  the INT 2Fh function CFFFh.  LSP installation uses the following return
  892.  codes:
  893.  
  894.  08 00     The NIF files were missing from the LSP source path
  895.  
  896.  12 00     Storage Medium Exception (I/O error)
  897.  
  898.  12 04     Device Not Ready
  899.  
  900.  16 00     Incorrect Program Invocation
  901.  
  902.  16 04     Unexpected Condition
  903.  
  904.  FE 00     Successful Program Execution - Reboot, and do not invoke again
  905.  
  906.  
  907.  
  908.                                                   Response File Processing  14
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  FE 04     Successful Program Termination - Warning messages logged, Reboot
  918.            and do not invoke again
  919.  
  920.  
  921.  LOG FILES
  922.  
  923.  One log file can be specified with the /L1: parameter.  This log file is
  924.  appended to if it already exists.  Errors and configuration information are
  925.  logged.
  926.  
  927.  
  928.  UNSUPPORTED FUNCTION IN RESPONSE FILE
  929.  
  930.  For the message "Function not supported in response file for driver
  931.  <drivername>.," check for the following conditions:
  932.  
  933.  o   The LSP driver name is misspelled.
  934.  
  935.  o   The PROT_SECTION is for an NDIS protocol driver other than DXME0MOD.SYS
  936.      (DXME0$) or DXMJ0MOD.SYS (NETBEUI$).
  937.  
  938.  o   The PROT_SECTION contains a driverfile=, but there is an IBM format NIF
  939.      available for the driver.
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.                                                   Response File Processing  15
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  APPENDIX A.  EXAMPLE RESPONSE FILES
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  DXMC0MOD.SYS AND DXMT0MOD.SYS, ONE ADAPTER
  989.  
  990.    * ----------------------------------------------------------------------
  991.    * EXAMPLE1.RSP
  992.    * This response file installs DXMC0MOD.SYS and DXMT0MOD.SYS.
  993.    * CONFIG.SYS and AUTOEXEC.BAT will be placed in the root of the C drive.
  994.    *
  995.    INST_SECTION = (
  996.       ; Do not use the input configuration for LSP driver parameters
  997.       MigrateControlFiles = 0
  998.  
  999.       ; Do not check the LAN adapters installed
  1000.       AdapterCheck = 0
  1001.  
  1002.       ; Define target location for LSP files
  1003.       TargetPath = c:\lsp135
  1004.       )
  1005.  
  1006.    ; Add 802.2 support for the shared RAM token ring adapter
  1007.    PROT_SECTION = (
  1008.       DriverName = DXMC0MOD$
  1009.       lsp_primary = 1
  1010.  
  1011.       ; Uncomment the next line and change for your LAA.
  1012.       ; NetAddress = "400000121212"
  1013.  
  1014.       ; Uncomment the next line and change for ISA-bus to change
  1015.       ; Shared RAM addr.
  1016.       ; RAM = 0xD800
  1017.  
  1018.       ; Uncomment the next line to turn off Early Token Release on 16MB.
  1019.       ; EarlyRelease = 1
  1020.  
  1021.       ; Uncomment the next line and change to set minimum link stations.
  1022.       ; MinLink = 2
  1023.  
  1024.       ; Uncomment the next line and change to set minimum SAPs.
  1025.       ; MinSAP = 12
  1026.  
  1027.       )
  1028.  
  1029.    ; Add NETBIOS driver to the configuration
  1030.    PROT_SECTION = (
  1031.       DriverName = DXMT0MOD$
  1032.  
  1033.       lsp_primary = 1
  1034.  
  1035.       ; Set the parameters needed by DLR.
  1036.  
  1037.  
  1038.  (C) Copyright IBM Corp. 1993                                              A-1
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.       c = 14
  1048.       st = 14
  1049.       s = 14
  1050.  
  1051.       ; Set the parameters needed by PC3270.
  1052.       es = 2
  1053.       est = 2
  1054.  
  1055.       ; Set the parameter needed in memory manager
  1056.       ; or Windows* environments.
  1057.       cf = y
  1058.  
  1059.       ; Turn off piggy-backed acknowledgements.
  1060.       PBA = 0
  1061.       )
  1062.    *** End of Response file EXAMPLE1
  1063.  
  1064.  
  1065.  DXMC0MOD.SYS AND DXMT0MOD.SYS, TWO ADAPTERS
  1066.  
  1067.    * ----------------------------------------------------------------------
  1068.    * EXAMPLE2.RSP
  1069.    * This response file installs DXMC0MOD.SYS and DXMT0MOD.SYS, 2 adapters.
  1070.    * It is just to illustrate setting parameters for two adapters with non-
  1071.    * NDIS LSP drivers.
  1072.    * CONFIG.SYS and AUTOEXEC.BAT will be placed in the root of the C drive.
  1073.    *
  1074.    INST_SECTION = (
  1075.       ; Do not use the input configuration for LSP driver parameters.
  1076.       MigrateControlFiles = 0
  1077.  
  1078.       ; Do not check the LAN adapters installed.
  1079.       AdapterCheck = 0
  1080.  
  1081.       ; Define target location for LSP files.
  1082.       TargetPath = c:\lsp135
  1083.       )
  1084.  
  1085.    ; Add 802.2 support for the shared RAM token ring adapter.
  1086.    PROT_SECTION = (
  1087.       DriverName = DXMC0MOD$
  1088.  
  1089.       ; Specify that two adapters will be supported.
  1090.       lsp_primary = 1
  1091.       lsp_alternate = 1
  1092.  
  1093.       ; Set some parameters for primary and for alternate.
  1094.       minlink = 2,4
  1095.       )
  1096.  
  1097.    ; Add NETBIOS driver to the configuration
  1098.    PROT_SECTION = (
  1099.       DriverName = DXMT0MOD$
  1100.  
  1101.  
  1102.  
  1103.                                       Appendix A.  Example Response Files  A-2
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.       ; DXMT0MOD.SYS is automatically added for both adapters.
  1113.       lsp_primary = 1
  1114.  
  1115.       ; Set some parameters for primary and for alternate.
  1116.       c = 14,12
  1117.       st = 14, 12
  1118.       s = 14, 12
  1119.  
  1120.       ; Set the parameters needed by PC3270.
  1121.       es = 2
  1122.       est = 2
  1123.  
  1124.       ; Set the parameter needed in memory manager
  1125.       ; or Windows* environments.
  1126.       cf = y
  1127.  
  1128.       ; Turn off piggy-backed acknowledgements.
  1129.       PBA = 0
  1130.       )
  1131.    *** End of Response file EXAMPLE2
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.                                       Appendix A.  Example Response Files  A-3
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  DXMJ0MOD.SYS AND IBMTOK.DOS, ONE ADAPTER
  1178.  
  1179.    * ----------------------------------------------------------------------
  1180.    * EXAMPLE3.RSP
  1181.    * This response file installs IBMTOK.DOS and DXMJ0MOD.SYS and does
  1182.    * not migrate any existing LSP parameters.
  1183.    * CONFIG.SYS and AUTOEXEC.BAT will be placed in the root of the C drive.
  1184.    *
  1185.    INST_SECTION = (
  1186.       ; Do not use the input configuration for LSP driver parameters.
  1187.       MigrateControlFiles = 0
  1188.  
  1189.       ; Do not check the LAN adapters installed.
  1190.       AdapterCheck = 0
  1191.  
  1192.       ; Define target location for LSP files.
  1193.       TargetPath = c:\lsp135
  1194.  
  1195.       ; DriverDiskPath specifies where the files normally found on the
  1196.       ; Driver Diskette (Option Diskette) are located.
  1197.       ; Change DRIVERS to the location of your NIF, NDIS MAC driver, etc.
  1198.       ; Note: DRIVERS is not fully qualified, so it will be searched for
  1199.       ;       1) in the current directory
  1200.       ;       2) as a subdirectory off of the LSP source path
  1201.       DriverDiskPath = DRIVERS
  1202.       )
  1203.  
  1204.    ; Specify bindings.  The protocol stack is DXMJ0MOD.SYS.
  1205.    PROT_SECTION = (
  1206.       ; The following statement specifies the DXMJ0MOD.SYS driver name.
  1207.       DriverName = NETBEUI$
  1208.  
  1209.       ; Change IBMTOK_MOD to the bracketed module name for the PROTOCOL.INI
  1210.       ; section for the NDIS MAC driver you are using.
  1211.       bindings = IBMTOK_MOD
  1212.  
  1213.       ; Turn off piggy-backed acknowledgements.
  1214.       PiggyBackAcks = 0
  1215.       )
  1216.    *** End of Response file EXAMPLE3
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.                                       Appendix A.  Example Response Files  A-4
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  DXME0MOD.SYS, DXMT0MOD.SYS AND IBMTOK.DOS, ONE ADAPTER
  1243.  
  1244.    * ----------------------------------------------------------------------
  1245.    * EXAMPLE4.RSP
  1246.    * This response file installs IBMTOK.DOS, DXME0MOD.SYS and DXMT0MOD.SYS
  1247.    * and does not migrate any existing LSP parameters.
  1248.    * CONFIG.SYS and AUTOEXEC.BAT will be placed in the root of the C drive.
  1249.    *
  1250.    INST_SECTION = (
  1251.       ; Do not use the input configuration for LSP driver parameters.
  1252.       MigrateControlFiles = 0
  1253.  
  1254.       ; Do not check the LAN adapters installed
  1255.       AdapterCheck = 0
  1256.  
  1257.       ; Define target location for LSP files
  1258.       TargetPath = c:\lsp135
  1259.  
  1260.       ; Change DRIVERS to the location of your NIF, NDIS MAC driver, etc.
  1261.       ; Note: DRIVERS is not fully qualified, so it will be searched for
  1262.       ;       1) in the current directory
  1263.       ;       2) as a subdirectory off of the LSP source path
  1264.       DriverDiskPath = DRIVERS
  1265.       )
  1266.  
  1267.    ; Specify bindings.  The protocol stack is DXME0MOD.SYS.
  1268.    PROT_SECTION = (
  1269.       ; The following statement specifies the DXME0MOD.SYS driver name.
  1270.       DriverName = DXME0$
  1271.  
  1272.       ; Change IBMTOK_MOD to the bracketed module name for the PROTOCOL.INI
  1273.       ; section for the NDIS MAC driver you are using.
  1274.       bindings = IBMTOK_MOD
  1275.  
  1276.       ; Uncomment the next line to use 'Original Ethernet Adapter Type'.
  1277.       ; X
  1278.  
  1279.       ; It is not recommended that the NetAddress parameter be used.
  1280.       ; The equivalent parameter for the MAC driver should be used instead.
  1281.       ; Uncomment the next line and change for LAA.
  1282.       ; NetAddress = "400000123456"
  1283.  
  1284.       ; Uncomment the next line and change for work space.
  1285.       ; WorkSpace = 8
  1286.  
  1287.       ; Uncomment the next line and change for ethernet type
  1288.       ; Transmit = 0
  1289.  
  1290.       ; Uncomment the next line and change for minimum SAPs.
  1291.       ; MinSAP = 2
  1292.  
  1293.       ; Uncomment the next line and change for minimum Link Stations.
  1294.       ; MinLink = 12
  1295.       )
  1296.  
  1297.  
  1298.                                       Appendix A.  Example Response Files  A-5
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.    PROT_SECTION = (
  1309.       ; The following statement specifies the DXMT0MOD.SYS driver name.
  1310.       DriverName = DXMT0MOD$
  1311.  
  1312.       ; The following statement adds this driver to the configuation.
  1313.       lsp_primary = 1
  1314.  
  1315.       ; Turn off piggy-backed acknowledgements.
  1316.       PBA = 0
  1317.       )
  1318.  
  1319.    PROT_SECTION = (
  1320.       DriverName = IBMTOK$
  1321.  
  1322.       ; The following statement would be needed if the sample protocol.ini
  1323.       ; did not contain a section for the MAC driver.  In that case,
  1324.       ; uncomment the statement and change the keyword value to match the
  1325.       ; target of the bindings= in the DXME0$ PROT_SECTION section (above).
  1326.       ; Section_Name = IBMTOK_MOD
  1327.  
  1328.       ; The following two statements would cause the MAC driver and message
  1329.       ; file to be copied to the target location for LSP files (c:\lsp135).
  1330.       ; They are only needed if there is no NIF file for the MAC driver in
  1331.       ; the DriverDiskPath.  In that case, uncomment the statements and
  1332.       ; change the keyword values to match those for your MAC driver.
  1333.       ; DriverFile = ibmtok.dos
  1334.       ; CopyFile = lt2.msg
  1335.       )
  1336.  
  1337.    *** End of Response file EXAMPLE4
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.                                       Appendix A.  Example Response Files  A-6
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  MIGRATION TO DXMJ0MOD.SYS AND IBMTOK.DOS
  1373.  
  1374.    * ----------------------------------------------------------------------
  1375.    * EXAMPLE5.RSP
  1376.    * This response file migrates to DXMJ0MOD.SYS with IBMTOK.DOS.
  1377.    * This response file migrates LSP parameters where possible.
  1378.    * If the existing configuration contains DXME0MOD.SYS, DXMT0MOD.SYS and
  1379.    * IBMTOK.DOS, then the resulting configuration will contain DXME0MOD.SYS
  1380.    * DXMJ0MOD.SYS and IBMTOK.DOS.
  1381.    * NOTE:  This example ASSUMES that the existing configuration contains
  1382.    *        IBMTOK.DOS.
  1383.    *
  1384.    INST_SECTION = (
  1385.       ; Use the input configuration for LSP driver parameters.
  1386.       MigrateControlFiles = 1
  1387.  
  1388.       ; Do not check the LAN adapters installed.  This effectively removes
  1389.       ; any non-NDIS LSP drivers from the configuration.
  1390.       AdapterCheck = 0
  1391.  
  1392.       ; Define target location for LSP files
  1393.       TargetPath = c:\lsp135
  1394.  
  1395.       ; Change DRIVERS to the location of your NIF, NDIS MAC driver, etc.
  1396.       ; Note: DRIVERS is not fully qualified, so it will be searched for
  1397.       ;       1) in the current directory
  1398.       ;       2) as a subdirectory off of the LSP source path
  1399.       ; DriverDiskPath is not necessary if the MAC driver is already in
  1400.       ; target path.
  1401.       DriverDiskPath = DRIVERS
  1402.       )
  1403.  
  1404.    PROT_SECTION = (
  1405.       ; The following statement specifies the DXMJ0MOD.SYS driver name.
  1406.       DriverName = NETBEUI$
  1407.  
  1408.       ; The following statement specifies that the MAC driver is IBMTOK.DOS
  1409.       ; Notice that it uses IBMTOK_NIF instead of IBMTOK_MOD.
  1410.       ; This is because the PROTOCOL.INI file on the workstation has '_NIF'
  1411.       ; appended to the driver file names (to generate the bracketed module
  1412.       ; names); whereas the sample PROTOCOL.INI shipped with LSP has '_MOD'
  1413.       ; appended to the driver file names.  Contrast with EXAMPLE3.RSP and
  1414.       ; EXAMPLE4.RSP.
  1415.       bindings = IBMTOK_NIF
  1416.  
  1417.       ; Turn off piggy-backed acknowledgements.
  1418.       PiggyBackAcks = 0
  1419.       )
  1420.    *** End of Response file EXAMPLE5
  1421.  
  1422.  
  1423.  DXMJ0MOD.SYS AND IBMTOK.DOS, TWO ADAPTERS
  1424.  
  1425.  
  1426.  
  1427.  
  1428.                                       Appendix A.  Example Response Files  A-7
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.    * ----------------------------------------------------------------------
  1438.    * EXAMPLE6.RSP
  1439.    * This response file installs IBMTOK.DOS and DXMJ0MOD.SYS for two
  1440.    * adapters and does not migrate any existing LSP parameters.
  1441.    * It illustrates using a PINIFILE parameter.
  1442.    * CONFIG.SYS and AUTOEXEC.BAT will be placed in the root of the C drive.
  1443.    *
  1444.    INST_SECTION = (
  1445.       ; Do not use the input configuration for LSP driver parameters.
  1446.       MigrateControlFiles = 0
  1447.  
  1448.       ; Do not check the LAN adapters installed
  1449.       AdapterCheck = 0
  1450.  
  1451.       ; Define target location for LSP files
  1452.       TargetPath = c:\lsp135
  1453.  
  1454.       ; Change DRIVERS to the location of your NIF, NDIS MAC driver, etc.
  1455.       ; Note: DRIVERS is not fully qualified, so it will be searched for
  1456.       ;       1) in the current directory
  1457.       ;       2) as a subdirectory off of the LSP source path
  1458.       DriverDiskPath = DRIVERS
  1459.       )
  1460.  
  1461.    ; The following statement causes the protocol.ini file, named
  1462.    ; PROTOCOL.CFG (in path RSP) to be processed.
  1463.    ; Since RSP\PROTOCOL.CFG is not fully qualified, it will be searched for
  1464.    ;       1) in the current directory
  1465.    ;       2) as a subdirectory off of the LSP source path
  1466.    ; The bindings and driver parameters are specified in PROTOCOL.CFG.
  1467.    ; See below for PROTOCOL.CFG.
  1468.    PINIFILE = RSP\PROTOCOL.CFG
  1469.  
  1470.    *** End of Response file EXAMPLE6
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.                                       Appendix A.  Example Response Files  A-8
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.    ;-----------------------------------------------------------------------
  1503.    ; PROTOCOL.CFG
  1504.    ;   Configuration with DXMJ0MOD.SYS and IBMTOK.DOS for two adapters.
  1505.    [PROTMAN_MOD]
  1506.            DriverName = PROTMAN$
  1507.    [DXMJ0MOD_MOD]
  1508.            DriverName = NETBEUI$
  1509.    ;   We are using IBMTOK_MOD instead of IBMTOK_NIF because we set
  1510.    ;   MigrateControlFiles to 0 in the INST_SECTION, therefore we are
  1511.    ;   using the sample LSP PROTOCOL.INI as the base PROTOCOL.INI (rather
  1512.    ;   than using a PROTOCOL.INI from an existing configuration which
  1513.    ;   would have '_NIF' instead of '_MOD' in the bracketed module names).
  1514.            Bindings = IBMTOK_MOD, IBMTOK2_MOD
  1515.  
  1516.    ;         Turn off piggy-backed acknowledgements.
  1517.            PiggyBackAcks = 0
  1518.    [IBMTOK_MOD]
  1519.            DriverName = IBMTOK$
  1520.            EARLYRELEASE
  1521.            MAXTRANSMITS = 6
  1522.            RECVBUFS = 2
  1523.            RECVBUFSIZE = 256
  1524.            XMITBUFS = 1
  1525.            XMITBUFSIZE = 2040
  1526.    [IBMTOK2_MOD]
  1527.            DriverName = IBMTOK2$
  1528.            EARLYRELEASE
  1529.            ALTERNATE
  1530.            MAXTRANSMITS = 6
  1531.            RECVBUFS = 2
  1532.            RECVBUFSIZE = 256
  1533.            XMITBUFS = 1
  1534.            XMITBUFSIZE = 2040
  1535.    ; End of PROTOCOL.CFG
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.                                       Appendix A.  Example Response Files  A-9
  1559.  
  1560.  
  1561.  
  1562.